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December 9, 2010 


1 Product Overview 


Novell Vibe OnPrem 3 offers many enhancements over prior Vibe versions for both Vibe users and 
administrators: 


For Users 


+ New User Interface: The user interface for Vibe 3 has been significantly redesigned to 
facilitate maximum productivity. 


+ Basic Search Improvements: Basic search now allows you to refine your search by field 
name, AND/OR statements, date range, and more. For more information, see “Using Basic 
Search” in the Novell Vibe OnPrem 3 User Guide. 


+ Advanced Search Improvements: When you perform an advanced search, you can now 
specify whether you want to search by relevance or date. For more information, see “Using 
Advanced Search” in the Novell Vibe OnPrem 3 User Guide. 


+ Expanded User Profile: The User Profile section in Vibe 3 has been expanded to rival other 
professional knowledgebases such as LinkedIn. You can now include more information to 
share with your colleagues, such as your education, qualifications, and competencies. For more 
information, see “Modifying Your Profile” in the Novell Vibe OnPrem 3 User Guide. 


If you have modified the User Profile definition for your Vibe site, these changes are not 
displayed when you upgrade to Vibe 3. To display these changes, complete the steps in 
“Resetting Your Definitions” in the Novell Vibe OnPrem 3 Installation Guide. 


+ Quick View Profile Dialog Box: The Quick View Profile dialog box is displayed when you 
click a user’s Presence icon &. It enables you to see information about that user, view the 
user’s micro-blog or workspace, follow the user, and more. 


If you have modified the User Profile definition for your Vibe site, this dialog box is not 
displayed when you upgrade to Vibe 3. To display these changes, complete the steps in 
“Resetting Your Definitions” in the Novell Vibe OnPrem 3 Installation Guide. 


+ Improved Folder and Workspace Branding: Adding a personal brand to your workspace or 
folder is easier than ever before with Vibe 3. For information about how you can quickly create 
a personal brand, see “Branding a Folder or Workspace” in the Novell Vibe OnPrem 3 
Advanced User Guide. 


+ Presence Integrations with Novell Messenger: Vibe 3 provides tight integrations with Novell 
Messenger, so you can use Vibe to see who is currently online. Presence icons & are located 
next to users’ names in folder entries. Click a user’s Presence icon to see information about that 
user, view the user’s micro-blog or workspace, follow the user, and more. 


¢ Integrations with Novell Conferencing: Vibe 3 provides tight integrations with Novell 
Conferencing, so you can start an instant meeting with other Vibe users directly from the Vibe 
interface. For more information, see “Using Novell Conferencing with Novell Vibe” in the 
Novell Vibe OnPrem 3 User Guide. 


Novell Vibe OnPrem 3 


2 


Entry-Level Access Controls: You can now set access controls on individual entries that 
differ from those set on the parent folder. For more information, see “Controlling Access to 
Entries” in the Novell Vibe OnPrem 3 Advanced User Guide. 


Delete Past Versions of Documents: You can now delete past versions of a document. 


Minor Versioning: You can now track documents on a more granular level. For example, 
instead of versions of a document being 1, 2, 3, Vibe documents can now be versioned as 1, 1.2, 
2, 2.2, 2.3, and so forth. 


Version Notes: You can now add personal notes to specific versions of a document. For more 
information, see “Adding a Note about a File or File Version” in the Novell Vibe OnPrem 3 
User Guide. 


For Administrators 


+ 


Support for Windows Authentication: You can configure a single sign-on experience for 
your users when Vibe is running on a Windows server. For more information, see “Configuring 
Single Sign-On with Internet Information Services for Windows” in the Novell Vibe OnPrem 3 
Installation Guide. 


Site-wide brand: You can create a site-wide brand and manage users’ ability to create 
individual brands on lower-level workspaces. For more information, see “Creating a Site-Wide 
Brand” in the Novell Vibe OnPrem 3 Administration Guide. 


Default home page: Vibe now allows you to set a default home page where all users are first 
taken when they access the Vibe site. You can create a separate default home page for visitors. 
For more information, see “Setting a Default Home Page” in the Novell Vibe OnPrem 3 
Administration Guide. 


User and group management: When you move or rename users and groups that are being 
synchronized via LDAP, Vibe now recognizes the change and maintains the association 
between the user or group that was moved or renamed and the LDAP server. For more 
information, see “LDAP Attribute to Identify a User” in the Novell Vibe OnPrem 3 Installation 
Guide. 


User Visibility: Vibe now allows you to hide one set of users from another set of users. For 
example, you might want to do this if your Vibe site has users from more than one company 
and you want users to see only the users who belong to the same company. For more 
information, see “Restricting Groups of Users from Seeing One Another” in the Novell Vibe 
OnPrem 3 Administration Guide. 


Integrations with Novell Messenger: Vibe 3 provides tight integrations with Novell 
Messenger, which allows Vibe users to see who is currently online in Vibe. Presence icons & 
are located next to users’ names in folder entries. 


Vibe administrators must configure Novell Messenger to work with Novell Vibe, as described 
in “Integrating Novell Vibe OnPrem with Novell Messenger” in the Novell Messenger 2.2 
Administration Guide. 


Integrations with Novell Conferencing: Vibe 3 provides tight integrations with Novell 
Conferencing, so you can start an instant meeting with other Vibe users directly from the Vibe 
interface. For more information, see “Using Novell Conferencing with Novell Vibe” in the 
Novell Vibe OnPrem 3 User Guide. 


Vibe administrators must configure Novell Messenger to work with Novell Conferencing, as 
described in “Novell Conferencing” in the Novell Vibe OnPrem 3 Administration Guide. 
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+ Using a Custom Address to Send Vibe Mail Messages: You can configure Vibe to send e- 
mail messages and notifications from a zone-specific or site-wide address. In previous versions 
of Vibe, when a user sends an e-mail message from Vibe, the message can be shown only as 
being from that specific user. 


For more information, see “Configuring Vibe to Send E-Mail Messages and Notifications from 
a Custom Address” in the Novell Vibe OnPrem 3 Administration Guide. 


2 Vibe System Requirements 


Novell Vibe 3 system requirements (including requirements for mobile devices that access the Vibe 
mobile interface) are listed in “Vibe OnPrem System Requirements” in the Novell Vibe OnPrem 3 
Installation Guide. 


3 Linux Installation Instructions 


1 Make sure that the Linux server where you plan to install Novell Vibe meets the system 
requirements. 


2 Ifa Web server is currently running on the Vibe server, stop it, and preferably disable it. 


3 Create or select anon-root Linux user and group that you want to own the Vibe directories and 
files and to run the Vibe software. 


4 Download the Vibe software to a temporary directory on your Linux server. 
5 Ina terminal window, become root by entering su - and the root password. 


6 Inthe directory where you downloaded and extracted the Vibe software, enter the following 
command to start the Vibe installation program: 


./installer -teaming. linux 


Complete installation instructions are available in the Novell Vibe OnPrem 3 Installation Guide. 


4 Windows Installation Instructions 


1 Make sure that the Windows server where you plan to install Novell Vibe meets the system 
requirements. 


Log in to the Windows server as a user with Administrator rights. 
If a Web server is currently running on the Vibe server, stop it, and preferably disable it. 


Download the Vibe software to a temporary directory on your Windows server. 


o fF WN 


In Windows Explorer, browse to the directory where you downloaded and extracted the Vibe 
software, then double-click the installer - teaming. exe file to start the Vibe Installation 
program. 


Complete installation instructions are available in the Novell Vibe OnPrem 3 Installation Guide. 


5 Update Issues 


¢ Section 5.1, “Incompatibility between Index Servers When Updating a High Availability 
System,” on page 4 


¢ Section 5.2, “Caching Issues When Updating from a Previous Vibe Release to Vibe 3 Beta 5 
and Later,” on page 4 
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¢ Section 5.3, “Issues When Updating from a Previous Vibe Release to Vibe 3,” on page 5 


¢ Section 5.4, “Performance Issues after Updating to a New Version,” on page 5 


5.1 Incompatibility between Index Servers When Updating a 
High Availability System 


When you update your high availability Vibe system to Vibe 3, any deferred log records that 
currently exist become incompatible with each other. 


To ensure that no incompatibility issues arise with deferred update logs during the upgrade to Vibe 
3, you must clear all deferred update logs prior to upgrading. 


For information on how to clear deferred update logs, see “Performing Maintenance on a High 
Availability Lucene Index” in the Novell Vibe OnPrem 3 Administration Guide. 


5.2 Caching Issues When Updating from a Previous Vibe 
Release to Vibe 3 Beta 5 and Later 


If you have done performance tuning for your Vibe cache, you might experience caching issues after 
you upgrade from a previous release to Vibe 3, if you have modified either of the following 
configuration files: 

¢ ehcache-hibernate. xml (single-server Vibe environment) 

¢ ehcache-hibernate-clustered. xml (clustered Vibe environment) 


You encounter issues only if you have modified either of the above files, because these files are 
overwritten during the Vibe upgrade. 


The issues you experience differ depending on whether you have a single-server Vibe environment, 
or whether you have a clustered Vibe environment. 


If you have modified the ehcache-hibernate. xml file in order to optimize the caching 
performance for your single Vibe server, you might notice a decrease in caching performance after 
you upgrade Vibe. 


If you have modified the ehcache-hibernate-clustered. xml file in order to configure your 
clustered environment, you might notice that items that are added to the Vibe site are not always 
visible, or other erratic behavior. This is because information is not being cached and synchronized 
correctly across the various Vibe servers. 


To resolve caching issues after an upgrade: 


1 Modify the ehcache-hibernate. xml file or the ehcache-hibernate-clustered. xml file 
to reflect the file’s state before the Vibe upgrade. 


The files are located in the following directories: 


Linux: /opt/novell/teaming/apache-tomcat/ 
webapps/ssf/WEB-INF/classes/config 


Windows: c:\Program Files\Novell\Teaming\apache-tomcat\ 
webapps\ssf\WEB- INF\classes\config 
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To see what these files looked like before the Vibe upgrade, you can look in the backup 
directories, in the following locations: 


Linux: /opt/novell/teaming/teaming-backup/ 
ssf/WEB-INF/classes/config 


Windows: c:\Program Files\Novell\Teaming\teaming-backup\ 
ssf\WEB-INF\classes\config 


IMPORTANT: Use these backup files only as a reference. Do not replace the entire ehcache- 
hibernate. xml file or ehcache-hibernate-clustered. xml file with the files in the backup 
directory. The new files contain important new settings that must be retained. You must 
manually add any customizations that existed in your old files. 


2 (Conditional) If you have a clustered Vibe environment and you need to modify the ehcache- 
hibernate-clustered.xml file, ensure that the values for the hostName, 
multicastGroupAddress, and multicastGroupPort properties are correct in the new 
ehcache-hibernate-clustered. xml file. 


3 Save any modifications that you made to the configuration files, then restart Vibe. 


5.3 Issues When Updating from a Previous Vibe Release to 
Vibe 3 


+ “Clearing Your Browser Cache” on page 5 


+ “Resetting Your Definitions” on page 5 


5.3.1 Clearing Your Browser Cache 


When upgrading to Vibe 3, each user who has used a previous version of Vibe must clear his or her 
browser’s cache, regardless of the browser he or she is using. Not clearing the browser cache results 
in an incorrect Vibe display. 


Ensure that you communicate this to each Vibe user in your system. 


5.3.2 Resetting Your Definitions 


Various aspects of the Vibe interface have been redesigned and enhanced in Vibe 3. Some of these 
enhancements affect entries, folders, user profiles, and user workspaces. If you have made 
customizations to these areas of Vibe, you must reset these definitions in order to see the Vibe 3 
enhancements. For more information, see “Resetting Your Definitions” in “Updating from Novell 
Teaming 2.1 to Novell Vibe 3” in the Novell Vibe OnPrem 3 Installation Guide. 


5.4 Performance Issues after Updating to a New Version 


After upgrading your Vibe system to a new version, you experience performance issues when you 
first navigate the Vibe system. This is because Vibe needs to compile the JSPs after an upgrade. 


These performance issues do not persist on subsequent visits to the Vibe site. 
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6 Installation Issues 


¢ Section 6.1, “The Vibe Server and the Lucene Server Must Use the Same JDK,” on page 6 
¢ Section 6.2, “Character Restrictions in Usernames and Passwords,” on page 6 


¢ Section 6.3, “Username Character Restrictions for LDAP Synchronization and Login,” on 
page 6 


¢ Section 6.4, “Character Restrictions in the Software Installation Directory Name,” on page 7 
¢ Section 6.5, “Character Restrictions in the File Repository Directory Name,” on page 7 
¢ Section 6.6, “Default Database Name,” on page 7 

¢ Section 6.7, “Restrictions on Applet Support,” on page 7 

¢ Section 6.8, “Edit in Place Support for Mac Users,” on page 8 

¢ Section 6.9, “NFS Support,” on page 8 

¢ Section 6.10, “Firewall Issue on Windows Server 2008,” on page 8 

¢ Section 6.11, “JDK Dependency for SSL Connections to WebDAV Servers,” on page 9 
¢ Section 6.12, “Updated Visual C++ Redistributable Package on Windows,” on page 9 

¢ Section 6.13, “Installation on a Double-Byte Linux Operating System,” on page 9 

¢ Section 6.14, “Compatibility with Access Manager,” on page 10 


6.1 The Vibe Server and the Lucene Server Must Use the Same 
JDK 


If Vibe and the Lucene Index are running on separate servers, you must use the same JDK for both 
servers. Using different JDKs results in undesired behavior, such as not being able to create calendar 
entries. 


6.2 Character Restrictions in Usernames and Passwords 


Do not use extended characters or double-byte characters in Novell Vibe usernames and passwords. 
This includes usernames and passwords that are synchronized from an LDAP directory into Vibe. 


This limitation is caused by the open source Spring Security (http://static.springframework.org/ 
spring-security/site) that Vibe uses for authentication, in combination with the various 
authentication methods (both basic authentication (http://en.wikipedia.org/wiki/ 
Basic_access_authentication) and form-based authentication (http://en.wikipedia.org/wiki/ 
Form_based_authentication)) used by single sign-on products such as Novell Authentication 
Manager, by Web services, and by WebDAV. Only ASCII characters are properly interpreted in all 
combinations. 


6.3 Username Character Restrictions for LDAP 
Synchronization and Login 
LDAP usernames that contain special characters (/\ * ? " < > : |) cannot be used as Novell Vibe 


usernames. If your LDAP directory includes usernames with these characters, they synchronize to 
the Vibe site, but the associated users cannot log in. 
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These characters cannot be used in a Vibe username because a Vibe username becomes the user’s 
workspace title, and the workspace title becomes an element of the hierarchical path that leads to the 
workspace. These characters are not legal characters in Linux and Windows pathnames. 


6.4 Character Restrictions in the Software Installation 
Directory Name 


Do not use extended characters or double-byte characters in the installation directory name for 
Novell Vibe file. The default location for the Vibe software is: 


Linux: /opt/novell/teaming 


Windows: c:\Program Files\Novell\Teaming 


6.5 Character Restrictions in the File Repository Directory 
Name 


Do not use extended characters or double-byte characters in directory names in the path to the 
Novell Vibe file repository. The default location for the file repository root directory is: 


Linux: /var/opt/novell/teaming 


Windows: c:\Novell\Teaming 


The Oracle Outside In viewers that are used to render various file types into HTML for viewing in 
the Vibe site and for indexing do not handle directory names that include extended characters and 
double-byte characters. 


6.6 Default Database Name 


When you have the Novell Vibe installation program create the Vibe database for you, the database 
is given the name of sitescape. This database name is currently hard-coded into the database 
creation scripts used by the installation program. The name dates back to the name of the company 
that previously owned the Vibe software. 


If you want the Vibe database to have a different name, you can edit the database creation script, 
then run the database creation script manually before you start the Vibe installation program. If you 
do this, you must also update the JOBC URL when you run the Vibe installation program. 


IMPORTANT: Changing the Vibe database name is not recommended. 


6.7 Restrictions on Applet Support 


Applets are not supported in the following environments: 


¢ Safari on Mac 
¢ 64-bit Firefox on a system with a Java Runtime Environment (JRE) earlier than 1.6.0_12 


On a 64-bit operating system, updating to JRE 1.6.0.12 or later enables the applets to work. 


Novell Vibe OnPrem 3 


8 


For example, multi-file drag-and-drop from the desktop, file paste from the desktop, Edit in Place, 
and the graphical display in the workflow editor do not work where applets are not supported. 


6.8 Edit in Place Support for Mac Users 


For Mac users, Vibe looks for OpenOffice.org in the following directory on users’ Mac 
workstations: 


/Applications/OpenOffice.org.app 


If your organization’s standard location for OpenOffice.org is in a different location on users’ 
workstations, you can reconfigure Vibe to look for OpenOffice.org in your preferred location. 


1 Change to the following directory: 


Linux: /opt/novell/teaming/apache-tomcat -version/ 
webapps/ssf/wEB-INF/classes/config 


Windows: c:\Program Files\Novell\Teaming\apache-tomcat-version\ 
webapps\ssf\WEB- INF\classes\config 


2 Open the ssf.properties file in a text editor. 

3 Locate the block of lines that start with: 
edit.in.place.mac.editor 

4 Copy that set of lines to the clipboard of your text editor. 


5 Open the ssf-ext.properties file, which is located in the same directory as the 
ssf.properties file. 


Paste the block of lines you copied at the end of the ssf-ext.properties file. 
Edit the location of the OpenOffice.org software to reflect its location in your organization. 


Save and close the ssf-ext. properties file. 


Oo ON O 


Close the ssf.properties file without saving it. 


10 Stop and restart Vibe to put the new software location into effect on your Vibe site. 


6.9 NFS Support 


NFS file system mounts are supported for placing the Vibe file repository on a remote server from 
where Vibe is running. However, NFS file system mounts are not supported for placing the Lucene 
index on a remote server from where the Lucene Index Server is running. 


6.10 Firewall Issue on Windows Server 2008 


On Windows Server 2008 R2, the firewall is enabled by default and ports 80 and 443 are blocked. 
Vibe needs to use these ports, so Vibe needs to be an allowed program on your Windows server. 


To prepare your Windows Server 2008 machine for use with Vibe: 


1 Inthe Control Panel, double-click Windows Firewall. 
2 Click Allow a program through Windows Firewall. 
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3 Open the ports that Vibe needs to use through the firewall: 
3a Click Add Port. 


3b In the Name field, specify a descriptive name for the HTTP port that Vibe uses for non- 
secure connections. 


3c In the Port field, specify 80. 
3d Click OK. 
3e Repeat Step 3a through Step 3d for the secure HTTP port of 443. 


4 After defining the two ports, click OK in the Windows Firewall Settings dialog box to allow 
Vibe to communicate through the firewall on these ports. 


6.11 JDK Dependency for SSL Connections to WebDAV 
Servers 


If you want to use an SSL connection between your Novell Vibe site and a WebDAV server, and if 
the WebDAV server has a self-signed certificate rather than a certificate provided by a certificate 
authority, you must use the Sun JDK. The existing Vibe functionality for handling self-signed 
certificates is not compatible with the way the IBM JDK handles self-signed certificates. 


6.12 Updated Visual C++ Redistributable Package on Windows 


Novell Vibe uses Oracle Outside In 8.3.0 viewer technology for displaying documents and images 
on the Vibe site and for indexing documents. This viewer technology relies on Support Pack 1 of the 
Microsoft Visual C++ 2005 Redistributable Package. If the Windows server where you install Vibe 
does not already have the latest version of the Visual C++ Redistributable Package installed, you 
must install it before your Vibe site can function properly. The required version of the Visual C++ 
Redistributable Package is available from: 


+ Microsoft Visual C++ 2005 SP1 Redistributable Package (x86) (http://www.microsoft.com/ 
downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D- 
389C36F85647 &displaylang=en) 


¢ Microsoft Visual C++ 2005 SP1 Redistributable Package (x64) (http://www.microsoft.com/ 
downloads/details.aspx?familyid=EB4EBE2D-33C0-4A47-9DD4- 
B9A6D7BD44DA &displaylang=en) 


For more information, see New Dependency for Outside In 8.2.0 and Newer Versions, Windows 
Products Only (Doc ID 468895.1) on the Oracle Support Web site (http://www.oracle.com/support). 
Oracle Support site login is required in order to access the support document. 


6.13 Installation on a Double-Byte Linux Operating System 


On Linux, the Novell Vibe installation program does not currently accept double-byte input in any 
input fields. 


To work around this limitation: 


1 Copy the sample-installer.xml file to create an installer. xml file. 


2 Open the installer .xm1 file in a text editor. 
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3 For a Basic installation: 


3a Inthe Network section, specify your settings for the following fields: 


name= 
port= 


listenPort= 
securePort= 
secureListinPort= 
shutdownPort= 
ajpPort= 
keystoreFile= 


3b In the Database section, specify your settings for the following fields for the type of 
database that you plan to use: 


username= 
password= 


3c Inthe InternalInboundsMTP section, specify your settings for the following fields in the 
subsection for either SMTP or secure SMTPS: 


mail. 
mail. 
mail. 
mail. 


smtp. 
smtp. 
smtp. 
smtp. 


host= 
user= 
password= 
port= 


3d Inthe Inbound section, specify your settings for the following fields in the subsection for 
POP3 or secure POP3S, or IMAP or secure IMAPS: 


mail. 
mail 
mail. 
mail 
mail. 
mail. 
mail. 
mail. 


pops. 
.pops. 
pops. 
. pops. 
imap. 
imap. 
imap. 
imap. 


host= 
user= 
password= 
port= 
host= 
user= 
password= 
port= 


4 For an Advanced installation, specify additional settings as needed. 


5 Save the installer.xml file, then exit the text editor. 


6 Run the Vibe installation program. 


The settings you specified in the installer .xm1 file display as defaults as you proceed 
through the installation. 


6.14 Compatibility with Access Manager 


To successfully use Novell Vibe with Novell Access Manager, Access Manager 3.1 SP1 IR1 is 
required. This version is available on the Novell Downloads Web site (http://download.novell.com). 


7 Teaming Issues 


¢ Section 7.1, “LDAP Synchronization Issue,” on page 11 


¢ Section 7.2, “Workspace Copy Limitation,” on page 12 


¢ Section 7.3, “Export/Import Limitation,” on page 12 


¢ Section 7.4, “Filenames That Contain Double-Byte Characters Are Changed When Creating a 
ZIP File,” on page 12 
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¢ Section 7.5, “File Deletion Issue with MySQL,” on page 12 

¢ Section 7.6, “File Rename Issue When Using WebDAV,” on page 13 

¢ Section 7.7, “Password-Protected Files,” on page 13 

¢ Section 7.8, “Mirrored Folder Structure Limitation,” on page 13 

¢ Section 7.9, “Mirrored Folder Versioning Limitation,” on page 13 

¢ Section 7.10, “License Report Issues,” on page 13 

¢ Section 7.11, “Date Attribute in Custom Entries and Views,” on page 13 
¢ Section 7.12, “Drag and Drop from a GroupWise Message,” on page 14 
¢ Section 7.13, “GroupWise Integration Issue,” on page 14 

¢ Section 7.14, “Firefox Limitation When Sending E-Mail,” on page 14 


¢ Section 7.15, “Windows Update for WebDAV Functionality for Windows Vista and Windows 
XP,” on page 15 


+ Section 7.16, “WebDAV/Edit in Place Issues with Microsoft Windows Vista and Microsoft 
Office,” on page 15 


¢ Section 7.17, “WebDAV/Edit in Place Issue on Windows 7,” on page 16 
¢ Section 7.18, “WebDAV URL Issue on Windows Vista and Windows 7,” on page 16 
¢ Section 7.19, “WebDAV Limitations on Mac,” on page 16 


¢ Section 7.20, “Viewing a Vibe Folder through Windows Explorer Displays an Additional 
Folder on Windows XP,” on page 17 


¢ Section 7.21, “Data Quota Issue with OpenOffice.org,” on page 17 
¢ Section 7.22, “HTML Conversion Error on SLES 10 SP3,” on page 17 
¢ Section 7.23, “The User Profile Does Not Support Custom JSP Files,” on page 18 


7.1 LDAP Synchronization Issue 


If you create Novell Vibe users by importing users from an LDAP directory, and if all users in the 
LDAP directory do not appear in Vibe, you might be experiencing one of the following issues: 


+ Your LDAP directory might not be using a consistent user attribute (exclusively uid or 
exclusively cn). Repeat the LDAP synchronization process and use the other user attribute. The 
remaining users should then appear in Vibe. 


+ If you selected cn, if you configured multiple contexts to search for users, and if you have 
multiple users with the same username, only the first instance of the duplicate username is 
synchronized into Vibe. 


To help prevent issues with your LDAP synchronization, you should specify an LDAP attribute that 
uniquely identifies the user. For more information, see “LDAP Attribute to Identify a User” in 
“LDAP Connections” in the Novell Vibe OnPrem 3 Installation Guide. 
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7.2 Workspace Copy Limitation 


When you copy a workspace, the custom form and workflow definitions in that workspace are not 
transferred to the copy of the workspace. You can work around this limitation by moving the 
definitions to a higher level in the workspace tree. 

1 Navigate to the folder in the original workspace where the definitions are located. 

2 On the Workspace toolbar, click Manage > Form and View Designers. 

3 Expand the Form and View Designers tree, then click the definition that you want to move. 

4 


In the Definition Properties box, click Move This Definition to display the workspace and 
folder tree for your Vibe site, then expand the tree as needed to display an appropriate 
destination for the definition. 


To make the definition available in the copy of the original workspace, move the definition to a 
location in the tree that is above both the original workspace and the copy of the workspace. 


To make the definition available globally on your Vibe site, move it to the root of the 
workspace and folder tree. 


To move the definition, select the destination, then click OK. 
Click Close twice to return to the main Vibe page. 


Verify that the definition is now available in the copy of the workspace. 


oN 0A 


Repeat this procedure for each definition that needs to be available in the copied workspace. 


7.3 Export/Import Limitation 


When you export a workspace or folder that includes links to external workspaces, folders, or 
entries, the target data pointed to by the external links is not exported along with the workspace or 
folder. The reference to the external target is exported, but external data is not exported because the 
hierarchy at the import location would probably not accommodate data that is not part of the 
exported workspace or folder. 


7.4 Filenames That Contain Double-Byte Characters Are 
Changed When Creating a ZIP File 


When Vibe 3 is used to create a ZIP file with files that contain double-byte characters in the 
filename, the filenames for the downloaded files are displayed as _file1, file2, _file3, etc. 
This is because the Java ZIP file facility is not capable of creating filenames that contain double- 
byte characters. 


The files within Vibe remain unchanged. 


For information on how to download files in Vibe, see “Downloading Files” in the Novell Vibe 
OnPrem 3 User Guide. 


7.5 File Deletion Issue with MySQL 


If you are using MySQL, you might see the following error when you upload files and then delete 
them: 
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class org.hibernate.exception.GenericJDBCException 
Cannot release connection 


This is related to a MySQL defect (http://bugs.mysql.com/bug.php?id=45357). To resolve the 
problem, update MySQL to version 5.1.40 (http://dev.mysql.com/downloads/mysq]). 


7.6 File Rename Issue When Using WebDAV 


Renaming a Vibe file through a WebDAV client renames the attachment file only. It does not rename 
the title of the Vibe folder entry that the file is associated with. 


This is because of the capability recently added to Vibe that allows you to specify any title of your 
choosing when creating a File entry, regardless of the filename of the associated file. Historically, 
the title for all File entries was the same as the filename of the associated file. 


7.7 Password-Protected Files 


Files that have been password-protected in the application where they were created cannot be 
viewed on the Novell Vibe site. This is working as designed. 


7.8 Mirrored Folder Structure Limitation 


You cannot use the Novell Vibe Move This Folder feature to move one Mirrored File folder inside of 
another Mirrored File folder. 


7.9 Mirrored Folder Versioning Limitation 


If you edit a file in a mirrored folder and then check the version history, you see only the latest 
version of the file and only the latest version of the file is available for editing from the mirrored 
location. This is working as designed. Document versioning is not currently available in mirrored 
folders. 


7.10 License Report Issues 


You can view current Novell Vibe license usage by clicking the Administration icon, then under 
Reports, clicking License Report. The License Report currently counts three internal, local users 
(_emailPostingAgent, _jobProcessingAgent, and _synchronizationAgent) as LDAP users. 
These internal users do not count against your Vibe license usage. The report also includes LDAP 
users with local users. 


7.11 Date Attribute in Custom Entries and Views 


If you use the Date attribute in a custom entry or view, users in different time zones might see a 
different date compared to what you see. 


Novell Vibe stores the date as midnight on the selected date in the Vibe user’s time zone in GMT. 
So, for example, January 13, 2010 in the Mountain time zone is stored as GMT-7:00 
(20100113T0700). No problem appears for people in the same time zone. However, for people in a 
different time zone, Mountain time zone midnight could be a different day for them in their time 
zone. This discrepancy will be resolved in an upcoming release. 
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7.12 Drag and Drop from a GroupWise Message 


In the GroupWise client, you cannot drag a file that is attached to a GroupWise message and drop it 
successfully into the Novell Vibe drag-and-drop window that opens when you click Add file to 
folder on the Folder Entry toolbar. Save the attachment first, then drag and drop the saved file into 
the drag-and-drop window. 


7.13 GroupWise Integration Issue 


In order to access a Novell Vibe site from the GroupWise Windows client, the time setting on the 
GroupWise user’s workstation must match the time setting on the Vibe server within five minutes. If 
there is a discrepancy of more than five minutes, the GroupWise client’s attempt to contact the Vibe 
site times out. If possible, reset the time of the server or the workstation to the correct and matching 
time. 


If the time difference is a necessary part of your system configuration, you can change the timeout 
setting for Web services such as GroupWise that authenticate to the Vibe site through WS-Security 
(http://en. wikipedia.org/wiki/Web_Services_Security). 


1 Make a backup copy of the following file: 
teaming_directory/webapps/ssf/wEB-INF/server -config.wsdd 

2 Open the server -config.wsdd file in a text editor. 

3 Search for the following section: 


<handler type="java:org.apache.ws.axis.security.WSDoA11Receiver"> 
<parameter name="passwordCallbackClass" 
value="org.kablink.teaming.remoting.ws.security.PwCallback"/> 
<parameter name="action" value="UsernameToken Timestamp"/> 
</handler> 


4 Insert a timeToLive parameter with large timeout value (for example, 86400 for 24 hours). 


<handler type="java:org.apache.ws.axis.security.WSDoA11Receiver"> 
<parameter name="passwordCallbackClass" 
value="org.kablink.teaming.remoting.ws.security.PwCallback"/> 
<parameter name="action" value="UsernameToken Timestamp"/> 
<parameter name="timeToLive" value="86400"/> 

</handler> 


5 Repeat Step 3 and Step 4 for the second instance of the section in the server -config.wsdd 
file. 


6 Save the server-config.wsdd file, then restart the server. 


This configuration change affects all client applications that authenticate to the server through WS- 
Security, not just GroupWise. 


7.14 Firefox Limitation When Sending E-Mail 


If you send an e-mail message from the Novell Vibe site, and you have a typographical error or 
invalid recipient in the Add E-Mail Addresses field, an error displays, along with a Return to 
Previous Page button. In Firefox, you return to the Send E-Mail page, but the message content is 
lost. In Internet Explorer, the message content is retained. 
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When you use Firefox to send e-mail from the Vibe site, select Vibe users as recipients whenever 
possible, or copy recipient e-mail addresses to avoid typographical errors in the Add E-Mail 
Addresses field. 


7.15 Windows Update for WebDAV Functionality for Windows 
Vista and Windows XP 


IMPORTANT: Install this update only on Windows Vista and Windows XP. Do not install this 
update on Windows 7. 


In order to use the Novell Vibe Edit in Place feature in your browser on Windows Vista and 
Windows XP, you must install the following Windows WebDAV update: 


Software Update for Web Folders (KB907306) (http://www.microsoft.com/downloads/ 
details.aspx?familyid=17C36612-632E-4C04-9382-987622ED1D64&displaylang=en). 


This Windows update enables OpenOffice.org and Microsoft Office to interact correctly with the 
Vibe Edit in Place feature. 


7.16 WebDAVI/Edit in Place Issues with Microsoft Windows 
Vista and Microsoft Office 


Microsoft Windows Vista has some issues with WebDAV access that affect all WebDAV 
interactions. In addition, a Vista-specific issue with applets can prevent the Novell Vibe Edit in 
Place feature from working properly. Be sure you are running the latest version of Vista. Be sure you 
have installed the Windows WebDAV update described in Section 7.15, “Windows Update for 
WebDAV Functionality for Windows Vista and Windows XP,” on page 15. 


Windows Vista users who are using Internet Explorer might see a Java warning when they try to use 
Edit in Place. (Firefox users do not see this error.) 


To configure Internet Explorer to support the Vibe Edit in Place feature: 


1 In Internet Explorer, click Tools > Internet Options. 
2 Click Security, select Trusted Sites, then click Sites. 
3 Inthe Add this website to the zone field, specify the URL of your Vibe server, then click Add. 


4 Select or deselect Require server verification (https:) for all sites in this zone as appropriate for 
your Vibe server. 


5 Click Close, then click OK to save the security settings. 
To configure Windows Vista to support the Vibe Edit in Place feature in Microsoft Office, you must 
add new keys to the Windows registry for each Microsoft Office application. 

1 In Windows Explorer, navigate to Program Files/Microsoft Office/Office12. 

2 Scroll down to each Microsoft Office .exe in turn: 


excel.exe 
powerpnt.exe 
winword.exe 


3 Right-click each executable, then click Properties. 
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4 Click Compatibility. 


5 Select Run this program in compatibility mode for, then select Windows XP (Service Pack 2) 
from the drop-down list. 


6 Reboot the computer. 


You should now be able to use the Vibe Edit in Place feature with Microsoft Office files. 


NOTE: Although these steps enable Edit in Place for Vibe, they do not fix Vista’s inability to attach 
via WebDAV in Vibe. 


For additional information on applets, view the following Sun bulletins: 


+ Bug 6440902 (http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6440902) 
¢ Bug 6432317 (http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6432317) 


7.17 WebDAVIEdit in Place Issue on Windows 7 


If you use the Novell Vibe Edit in Place feature to edit a Word document using Office 2007 or Office 
2010 on a Windows 7 workstation, Word requests a location to save the edited file rather than saving 
it back to the Vibe site. Depending on whether you want to run Vibe with a secure HTTPS) or non- 
secure (HTTP) connection, this affects how you need to configure Vibe. For more information, see 
“Editing Files with Edit-in-Place Functionality” in “Configuring Vibe to Support WebDAV on 
Windows 7” in the Novell Vibe OnPrem 3 Administration Guide. 


7.18 WebDAV URL Issue on Windows Vista and Windows 7 


If you copy the WebDAV URL associated with a Novell Vibe folder and try to use the Add Network 
Location feature, Windows Vista and Windows 7 might not be able to map the drive. Instead, you 
should always use the Map Network Drive feature when using Vibe on Windows Vista and 
Windows 7. 


7.19 WebDAV Limitations on Mac 


When using WebDAV functionality in a Mac environment, you encounter various limitations. 


¢ “Limitations When Editing Files on Mac through WebDAV” on page 16 
¢ “Limitations When Viewing a Vibe Folder on Mac through WebDAV” on page 16 


7.19.1 Limitations When Editing Files on Mac through WebDAV 


Edit-in-Place functionality is not supported on Mac when you use Microsoft Office as your 
document editor. To use Edit-in-Place functionality on Mac, you must use OpenOffice as your 
document editor. 


For more information, see “Using WebDAV to Edit Individual Files” in the Novell Vibe OnPrem 3 
Advanced User Guide. 


7.19.2 Limitations When Viewing a Vibe Folder on Mac through WebDAV 


Because of limitations with WebDAV on Mac, you cannot use WebDAV to view a Vibe folder in a 
Mac environment. 
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For more information, see “Using WebDAV on a Vibe Folder” in the Novell Vibe OnPrem 3 
Advanced User Guide. 


7.20 Viewing a Vibe Folder through Windows Explorer Displays 
an Additional Folder on Windows XP 


On Windows XP, when you view a Vibe folder through Windows Explorer, an additional sub-folder 
with the same name as the parent folder might be displayed. 


To resolve this problem: 


1 Launch a Web browser. 


2 Navigate to the Microsoft Download Center and install the Software Update for Web Folders 
(KB907306) (http://;www.microsoft.com/downloads/details.aspx? Familyld=17C36612-632E- 
4C04-9382-987622ED1D64&displaylang=en) 


3 Follow the on-screen instructions to install the software update. 


7.21 Data Quota Issue with OpenOffice.org 


OpenOffice.org creates a new document version each time you click Save, instead of creating one 
new version when you exit the edited document. This behavior can cause you to quickly meet your 
data quota. You can avoid creating unnecessary versions of the same document, and if you do create 
them, you can delete them. 


+ “Avoiding Unnecessary Document Version Creation” on page 17 


+ “Deleting Unnecessary Versions of a Document” on page 17 


7.21.1 Avoiding Unnecessary Document Version Creation 
To avoid creating unnecessary versions of the same document, do either of the following: 


¢ Do not click Save multiple times when editing a document. Instead, click Save only once, 
before closing the document in OpenOffice.org. 


+ When you edit documents in Vibe, use a document editor other than OpenOffice.org, such as 
Microsoft Word. 


7.21.2 Deleting Unnecessary Versions of a Document 


You can delete specific versions of a file, as described in “Deleting Existing Versions of a File” in 
the Novell Vibe OnPrem 3 User Guide. 


7.22 HTML Conversion Error on SLES 10 SP3 


If you see an HTML Conversion Error when you try to view a file, your Vibe server might be 
missing necessary libraries. 


To install the missing libraries: 


1 Change to the following directory: 


/opt/novell/teaming/stellent-converter/linux/x86 
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2 Run the exporter program. 
The errors about missing input and output files are to be expected. 
3 Look for errors about missing libraries. 


4 If there are library errors, install any libraries that are missing. 


7.23 The User Profile Does Not Support Custom JSP Files 


When you create or modify attributes for the User Profile form and view in the Form and View 
Designers tool, you cannot reference custom JSP files. 


This ability still exists for modifying attributes for workspaces, folders, and entries, as described in 
“Enabling Vibe Forms and Views to Reference JSP Files” in the Novell Vibe OnPrem 3 Advanced 
User Guide. 


8 Developer Issues 


+ Section 8.1, “Multi-Reference Values in SOAP Payloads,” on page 18 


8.1 Multi-Reference Values in SOAP Payloads 


By default, Novell Vibe SOAP payloads do not generate multi-reference values. You can change the 
server -config .wsdd files so that multi-reference values are generated. 
1 Change to the directory where a server -config.wsdd file is located. 


A Vibe installation includes two server -config .wsdd files. The default locations of these 
files vary by platform: 


Linux: /opt/novell/teaming/apache- tomcat -version/webapps/ssf/WEB- INF 
/opt/novell/teaming/apache-tomcat -version/webapps/ssr/WEB- INF 


Windows: c:\Program Files\Novell\Teaming\apache-tomcat -version\webapps\ 
ssf\WEB- INF 

c:\Program Files\Novell\Teaming\apache-tomcat -version\webapps\ 
ssr\WEB- INF 


2 Inthe following line: 
<parameter name="SendMultiRefs" value="false"/> 
change false to true. 

3 Save the server -config .wsdd file, then exit the text editor. 

4 Create a backup copy of the modified server -config .wsdd file. 


If you update the Vibe software, the server -config.wsdd file is overwritten by the Vibe 
Installation program. You must either restore the updated file after the update or repeat the 
modification. 


5 Repeat the procedure for the second server -config .wsdd file in the Vibe software. 


9 Localization Issues 


¢ Section 9.1, “XSS Report Is Not Localized,” on page 19 
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¢ Section 9.2, “User Names with Extended Characters Do Not Display in E-Mail Messages 
When Viewed in GroupWise,” on page 19 


¢ Section 9.3, “Extended Characters Are Not Allowed in Simple URLs,” on page 20 
¢ Section 9.4, “Extended and Double-Byte Characters in Attachment Filenames,” on page 20 
¢ Section 9.5, “Chinese Characters in Activity Logs,” on page 20 


¢ Section 9.6, “Internet Explorer 6 Limitation with International Characters in Filenames,” on 
page 20 


9.1 XSS Report Is Not Localized 


The cross-site scripting (XSS) report described in “Cross-Site Scripting Report” inthe Novell Vibe 
OnPrem 3 Administration Guide is available only in English for the Vibe OnPrem 3 release. 


9.2 User Names with Extended Characters Do Not Display in E- 
Mail Messages When Viewed in GroupWise 


User names that contain extended characters are not displayed in the From area of e-mail messages 
that are sent from Vibe and are viewed in GroupWise. 


To resolve this issue, you need to modify the startup scripts for your Vibe server. The startup scripts 
and their locations differ slightly depending on whether your Vibe installation is running on a Linux 
or a Windows server. 

+ “Linux” on page 19 


+ “Windows” on page 19 


9.2.1 Linux 


1 Open the catalina. sh file in a text editor. This file is located in the following directory: 
opt/novell/teaming/apache-tomcat/bin 

2 Search for UTF8 in the file, then change this to UTF-8. 

3 Stop and restart the Vibe server. 


9.2.2 Windows 


1 Open the service. bat file in a text editor. This file is located in the following directory: 
c:\Program Files\Novell\Teaming\apache-tomcat\bin 

2 Search for UTF8 in the file, then change this to UTF-8. 

3 Open the catalina. bat file in a text editor. This file is located in the following directory: 
c:\Program Files\Novell\Teaming\apache-tomcat\bin 

4 Search for UTF8 in the file, then change this to UTF-8. 

5 Stop and restart the Vibe server. 
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9.3 Extended Characters Are Not Allowed in Simple URLS 


On the Configure Default Settings page of your workspace, the Define URL field does not accept 
extended characters. Use only alphabetic characters and numbers in simple URLs. 


9.4 Extended and Double-Byte Characters in Attachment 
Filenames 

If Outlook users send postings to the Novell Vibe site and if the messages have attachments with 
extended or double-byte characters in the filenames, the attachment does not arrive on the Vibe site 
unless the Exchange server is properly configured. To configure the Exchange server to pass the 
filenames correctly, follow the instructions in Foreign Characters Appear as Question Marks When 


Sent from OWA (http://www.windowsnetworking.com/kbase/WindowsTips/Windows2000/ 
AdminTips/Exchange/ForeigncharactersappearasquestionmarkswhensentfromOWA. html). 


9.5 Chinese Characters in Activity Logs 


When a report . csv file for an activity report is opened in Microsoft Excel, Chinese characters do 
not display correctly, even though the report . csv file has been created correctly, because Excel 
always reads the file using the ISO Latin character set. 


One workaround is to use the OpenOffice.org Calc spreadsheet program instead of Excel. It displays 
Chinese characters correctly. 


As a workaround in Excel: 


1 Import the report.csv file into Excel by using Data > Import External Data > Import Data. 
2 Select the report . csv file, then click Open. 
3 Select Delimited, select UTF-8, then click Next. 


4 Select Comma as the delimiter, click Next, then click Finish. 


Excel should now display the Chinese characters correctly. 


9.6 Internet Explorer 6 Limitation with International Characters 
in Filenames 

In Internet Explorer 6, if you upload a file whose filename includes international characters into a 
File folder, and if you edit that file and create a new version, the link to the original version of the 


file no longer works, because Internet Explorer 6 double-encoded the filename. To resolve this issue, 
update to Internet Explorer 7 or later. 


10 Security Issue 


To ensure that your Novell Vibe site is adequately secure, keep your operating system updated with 
all patches and security fixes. 
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11 Vibe Documentation 


The following sources provide information about Novell Vibe 3: 
¢ Online product documentation: Novell Vibe 3 Documentation Web site (http:// 
www.novell.com/documentation/vibe_onprem3) 
¢ Product documentation included within Novell Vibe: 
Click the Help icon (question mark) in the upper right corner of the Vibe Home page. 
In addition to the Novell Vibe product documentation, the following resources provide additional 
information about Vibe 3: 
+ Novell Vibe product site (http://www.novell.com/products/vibe-on-premise/) 


+ Novell Vibe OnPrem Resource Library (http://www.novell.com/products/vibe-on-premise/ 
resource-library/) 


+ Novell Vibe OnPrem Cool Solutions (http://www.novell.com/communities/coolsolutions/vibe- 
onprem) 


+ Novell Vibe Support Forum (http://forums.novell.com/novell-product-support-forums/ 
teaming/) 


12 Legal Notices 


Novell, Inc. makes no representations or warranties with respect to the contents or use of this 
documentation, and specifically disclaims any express or implied warranties of merchantability or 
fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication 
and to make changes to its content, at any time, without obligation to notify any person or entity of 
such revisions or changes. 


Further, Novell, Inc. makes no representations or warranties with respect to any software, and 
specifically disclaims any express or implied warranties of merchantability or fitness for any 
particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of 
Novell software, at any time, without any obligation to notify any person or entity of such changes. 


Any products or technical information provided under this Agreement may be subject to U.S. export 
controls and the trade laws of other countries. You agree to comply with all export control 
regulations and to obtain any required licenses or classification to export, re-export, or import 
deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion 
lists or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not 
use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. Please 
refer to the Novell International Trade Services Web page (http://www.novell.com/info/exports/) for 
more information on exporting Novell software. Novell assumes no responsibility for your failure to 
obtain any necessary export approvals. 


Copyright © 2010 Novell, Inc. All rights reserved. No part of this publication may be reproduced, 
photocopied, stored on a retrieval system, or transmitted without the express written consent of the 
publisher. 
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Novell, Inc. has intellectual property rights relating to technology embodied in the product that is 
described in this document. In particular, and without limitation, these intellectual property rights 
may include one or more of the U.S. patents listed on the Novell Legal Patents Web page (http:// 
www.novell.com/company/legal/patents/) and one or more additional patents or pending patent 
applications in the U.S. and in other countries. 


For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/ 
company/legal/trademarks/tmlist.htm]). 


All third-party trademarks are the property of their respective owners. 
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